home *** CD-ROM | disk | FTP | other *** search
/ Just Call Me Internet / Just Call Me Internet.iso / prog / atari / c / snz128s / doc / snewshst.txt < prev   
Text File  |  1994-06-18  |  64KB  |  1,538 lines
  1. Demon Internet Simple News v1.28
  2. ================================
  3.  
  4. [ This is a copy of the standard PC documentation with the Atari specific ]
  5. [ details interspersed.                                                   ]
  6.  
  7. [Atari differences indicated thus].
  8.  
  9. [ Atari port by Graham Judd - gjudd@siward.demon.co.uk                    ]
  10. [                             gjudd@cix.compulink.co.uk                   ]
  11. [ Port released 18 June 1994.                                             ]
  12. [ Please note that I am working in California until the end of September  ]
  13. [ 1994 and I will not be available for any support questions so use this  ]
  14. [ release at your own risk!                                               ]
  15.  
  16. GENERAL
  17. =======
  18.  
  19.     1.28 is a minor upgrade to fix bugs that have been reported in 
  20.     Snews 1.27 over the last 4 months.
  21.  
  22.     Colour processing from the snews.rc file now ignores incomplete
  23.     lines, rather than setting to black.
  24. [   Colour is not supported in the Atari port].
  25.     
  26.  
  27.     Support has been added for a list of suspended newsgroups. This
  28.     is functional in Snews, but will only be of real value when the
  29.     DIS front end has been updated to support suspended newsgroups.
  30.  
  31.     The suspend list is an ascii file containing one newsgroup per
  32.     line. The file is called 'suspend' and should be placed in the
  33.     snews directory, the same location as the file 'active'.
  34.  
  35.     A newsgroup placed on the suspend list is highlighted in Snews
  36.     newsgroup display with brackets '[----]' and is bypassed by the
  37.     normal TAB key reading functions unless deliberately entered using
  38.     the enter or arrow keys.
  39.  
  40.     Attempts to post to or follow up in a suspended group are met
  41.     with a warning message, which must be accepted before posting
  42.     is permitted.
  43.  
  44.     Rmgroup will refuse to delete any newsgroup on the suspend list.
  45.  
  46.     NOTE: Unbatch and Expire will still process suspended groups as
  47.     normal.
  48.  
  49. UNBATCH
  50. =======
  51.  
  52. 1)   Error checking has been improved in a number of situations where
  53.      previously error handling was left to DOS.
  54.  
  55. 2)   Unbatch now attempts to remove all its lock files when it finishes.
  56.      This can not be 100% as there are valid reasons for not removing
  57.      lock files. (e.g. Removing lock files when they were present
  58.      before unbatch was invoked)
  59.  
  60. 3)   Unbatch did not account for the increasing size of the in memory
  61.      history list when running. This is the cause of some of the 'out
  62.      of memory' errors. Corrected.
  63.  
  64. 4)   The bugs preventing unbatch processing multiple batch files in a
  65.      single pass have been corrected.
  66.  
  67. [    The function of the -f and -l switches have been reversed.         ]
  68. [    If -f is specified, it now means DO NOT filter non-printables.     ]
  69. [    If -l is specified, it now means DO check article length.          ]
  70. [    I have done this because the default action for -f could cause     ]
  71. [    bus errors and I have not had time to find out why;                ]
  72. [    and the default action for -l was causing #!rnews headers to be    ]
  73. [    missed, with the result that messages were being appended to       ]
  74. [    other messages and hence being placed into the wrong group.        ]
  75. [    If you are specifying either the -f or -l switches when running    ]
  76. [    unbatch, do not do so; if you were not, you will have to specify   ]
  77. [    them to get the same functionality as SNews1.27.  I would          ]
  78. [    recommend that you do not specify these switches unless you have   ]
  79. [    a particular need to do so.                                        ]
  80.  
  81. SNEWS
  82. =====
  83.  
  84. 1)   The 'K' command now prompts for confirmation (in non expert mode)
  85.      at both the thread and article levels.
  86.  
  87. 2)   The 'o' command is now supported at the thread level for printing
  88.      a full thread.
  89. [    I inadvertantly forgot to define 'stdprn' to be 'stdprt'.  It is   ]
  90. [    defined to 'stderr' so printing will be to the screen unless you   ]
  91. [    can redirect stderr.  You will have to save a group/thread/article ]
  92. [    and then print the saved file.  Sorry...                           ]
  93.  
  94. 3)   At the thread and article levels the 's' command now permits an
  95.      abort, replace or append choice if the file named already exists.
  96.  
  97. 4)   XX.YY style added to smart thread matching routine.
  98.  
  99. 5)   The text from an entire newsgroup can be saved by entering 's' at
  100.      the newsgroup selection screen, with the pointer marking the
  101.      group to be saved.
  102.  
  103. 6)   In article display, lines were being wrapped 1 column early. e.g.
  104.      at col 79 on an 80 col display. Corrected.
  105.  
  106. 7)   There is a limit in alias handling in that a name prompt can be
  107.      answered with an alias, *or* a proper name. A mixture of alias
  108.      and full names, or multiple aliases is not correctly processed.
  109.      This, and the limitation of aliases not being accepted after
  110.      entering the editor will be addressed in a future version.
  111.  
  112. 8)   When an article with follow-up to poster is followed up, but to
  113.      the newsgroup, not the sender, it was posted to newsgroup 'poster'.
  114.      Corrected.
  115.  
  116. 9)   New item in snews.rc - footers. When set to 'on' snews will add
  117.      the signature separator "-- " before the signature and will also
  118.      stop quoting included text (for example when quoting messages for
  119.      followups) when this separator is found. The default is 'on' which
  120.      corresponds with current behaviour for adding the separator. This
  121.      setting can be altered for the current session from the F3 settings
  122.      screen.
  123. [    So, if you have "-- " in your .sig file, take it out.                ]
  124.  
  125. 10)  If a newsgroup is on the suspend list, it is displayed on the
  126.      newsgroup selection screen enclosed in square brackets '[--]'.
  127.      Selecting groups by the TAB key, will bypass this group, rather
  128.      than enter it of there are any new articles to read. Enter and
  129.      arrow keys will still enter the suspended group.
  130.  
  131. EXPIRE
  132. ======
  133.  
  134. 1)   A check has been added to prevent expire removing out of time
  135.      sequence articles when expiring articles. This should reduce the
  136.      incidence of 'Article xx found, when yy expected'.
  137.  
  138.    Thanks to ubik.demon.co.uk for assistance in adding this feature.
  139.  
  140. 2)   If articles are found out of time sequence when expiring, they are
  141.      now retained and the time corrected to match the sequence.
  142.  
  143. 3)   The bug preventing 'expire 0' from working has been corrected.
  144.  
  145. REINDEX
  146. =======
  147.  
  148.      No changes.
  149.  
  150. ADDGROUP
  151. ========
  152.      No changes.
  153.  
  154.  
  155. RMGROUP
  156. =======
  157.  
  158. 1)   If a newsgroup is on the suspend list, rmgroup will refuse to 
  159.      remove the newsgroup form the active file.
  160.  
  161. Malcolm@muir.demon.co.uk
  162. 2 Apr 1994
  163. =========================================================================
  164. [ gjudd@siward.demon.co.uk, gjudd@cix.compulink.co.uk                     ]
  165. [ 18 June 1994                                                            ]
  166. [ Please note that I am working in California until the end of September  ]
  167. [ 1994 and I will not be available for any support questions so use this  ]
  168. [ release at your own risk!                                               ]
  169. =========================================================================
  170. Demon Internet Simple News v1.27
  171. ================================
  172.  
  173. GENERAL
  174. =======
  175.  
  176.     1.27 is a minor upgrade to overcome a problem in setting the
  177.     organization header blank. Knows bugs since 1.26 have been fixed
  178.     and one new feature added.
  179.  
  180. SOURCE CODE CONTROL
  181. ===================
  182.  
  183.     I have now changed to using Microsoft Delta as my source code
  184.     control tool. (In parallel with GNU RCS at present) the only
  185.     effect of this is the appearance of a new file in the source
  186.     (version.h) and a change in the version number format shown by
  187.     the 'v' command.
  188.  
  189. UNBATCH
  190. =======
  191.  
  192. 1)  Subject lines when extracted from articles are now limited to 128
  193.     characters. Long subjects are a cause of index corruption during
  194.     expire and this change should reduce the occurrence of corruption
  195.     of news during expire. It will however not be fully effective until
  196.     all the old news is expired from a newsbase.
  197.  
  198. SNEWS
  199. =====
  200.  
  201. 1)  The article header display routine was being broken by any (rare)
  202.     articles with Newsgroups: header lines > 256 characters. The buffer
  203.     size is now 512 characters.
  204.  
  205. 2)  Entering 'q' or ESC when displaying an article marked that article
  206.     as read. This is possibly not what is implied by quitting. These keys
  207.     now leave the article unread.
  208.  
  209. 3)  The article display header was showing double 'at' separators. Fixed. 
  210.  
  211. 4)  A blank 'organization' line is now acceptable in snews.rc and results
  212.     in the organization header line being omitted from the article / mail.
  213.  
  214. 5)  References lines are restricted to 256 characters when quoting previous
  215.     article references.
  216.  
  217. 6)  Followup articles now quote the subject from the article being
  218.     followed-up not the first article in the thread.
  219.  
  220. 7)  An new item 'matchlength' has been added to snews.rc
  221.  
  222.     This item determines how the subject threading is handled. By default
  223.     if a subject is less that 15 characters, the full subject lines must
  224.     match for both articles to be considered to be the same thread.
  225.     If the subjects are both longer that 15 characters, then the match
  226.     is only performed for the shorter of the two subjects.
  227.  
  228.     matchlength allows this default of 15 to be changed.
  229.  
  230.     Special cases:
  231.         128 - both subjects must be an exact match.
  232.          -1 - Subjects will never match.
  233.  
  234.     At the time or writing matchlength is not supported by DIS.EXE
  235.  
  236. 8)  A line at the bottom of the screen was cleared to the wrong colour
  237.     when the confirmatory message is displayed after posting / mailing.
  238.     This has been corrected.
  239.  
  240.  
  241. EXPIRE
  242. ======
  243.  
  244. 1)  Subject line lengths are now restricted to 128 characters when reading
  245.     and re-writing the index files.
  246.  
  247.  
  248. REINDEX
  249. =======
  250.  
  251. 1)  Changes made to the active file are now recorded in the messages
  252.     produced on completion. 
  253.  
  254.  
  255. 2)  Subject line lengths are restricted to 128 characters when re-writing
  256.     the index files.
  257.  
  258. Malcolm@muir.demon.co.uk
  259.  5 Dec 1993
  260. =========================================================================
  261.  
  262. Simple News 2.0 DIS 1.26
  263. ========================
  264.  
  265. General
  266. =======
  267.  
  268. 1)  This is a minor bugfix release to Snews 1.25
  269.  
  270. Snews
  271. =====
  272.  
  273. 1)  If a followup was made to an article with a references line longer than
  274.     255 characters, Snews crashed. Corrected. (References lines for
  275.     followup articles are now restricted to 240 characters)
  276.  
  277. 2)  I have a number of reports of unpredictable behaviour after 's'aving
  278.     a thread or article. Whilst not a bug, Snews waits for a character
  279.     press to clear the 'article(s) saved' message. Most information
  280.     messages now require a key press in this form, however this particular
  281.     one failed to say 'press any key'. I have added this message. The usual
  282.     problem with pressing function keys or arrow keys at this prompt still
  283.     exists however. (It will be addressed soon)
  284.  
  285. 3)  The From: line in the article display header has been reformatted for
  286.     better display in 132 column mode.
  287.  
  288. 4)  In non expert mode, 'z' at the article selection menu, followed by 'y'
  289.     caused Snews to hang. Corrected.
  290.  
  291. 5)  The help screen layouts have been corrected and new items added.
  292.  
  293. 6)  The Page up and Page down commands at the newsgroup and thread
  294.     selection screens now consistently move one half page up or down.
  295.     This removes the previous problem of skipping newsgroups when the
  296.     pointer was in the lower half of the screen.
  297.  
  298.     The 'b' and ' ' (space) keystrokes for paging up and down still
  299.     operate the old way and will be changed on a future release if
  300.     the new way is accepted.
  301.  
  302. 7)  When in non-expert mode, you are now prompted to confirm the name
  303.     of the addressee when 'r'eplying to an article. If you answer 'no'
  304.     an opportunity is given to enter the address you require.
  305.  
  306.  
  307. Unbatch
  308. =======
  309.  
  310. 1)  A new line was not being output after unbatch asked the question about
  311.     loading a partial history file.
  312.  
  313. Reindex
  314. =======
  315.  
  316. 1)   The handling of the 'cursor' in the newsgroup selection screen has
  317.      been changed to improve compatibility with speech processors. 
  318.  
  319. Malcolm S. Muir
  320. 13 Nov 93
  321. ===========================================================================
  322.  
  323. Simple News 2.0 DIS 1.25
  324. ========================
  325.  
  326. General
  327. =======
  328.  
  329. 1)   Snews 1.25 source now compiles under Microsoft C 8 without source
  330.      changes. (The compiler conditional __TURBOC__ is used for control)
  331.      Only one warning is produced at level 3. Minimal testing has been
  332.      carried out with the MSC executables, but no differences have so
  333.      far been noted. The Borland version is still the version being
  334.      distributed.
  335.  
  336. Snews
  337. =====
  338.  
  339. 1)   The functions of 's' and 'S' have been reversed to be consistent with
  340.      earlier version of Snews.
  341.  
  342. 2)   The Newsgroup and Thread displays have been moved down one row to
  343.      their correct position relative to the header.
  344.  
  345. 3)   An abort option is added to the question 'Quote Article' in both
  346.      posting followup and reply to article. Entering 'a' at this prompt
  347.      aborts the followup / mail completely.
  348.  
  349. 4)   A number of 'y'es 'n'o prompts were case sensitive. These have been
  350.      changed to case insensitive.
  351.  
  352. 5)   A new configuration item 'TAB' is added to Snews.rc to control the
  353.      action of the TAB key when reading news. The default action is the
  354.      new style action of moving through unread articles by simply hitting
  355.      the tab key. To return to the old style TAB action, set the TAB item
  356.      to "off".
  357.  
  358.      For example:
  359.  
  360.      TAB=OFF
  361.  
  362.      If there is no TAB item, or TAB is set to 'on', the new style tab
  363.      reading will be enabled.
  364.  
  365. 6)   A new configuration item 'HEADERS' is added to Snews.rc to control the
  366.      quoting of headers into quoted articles. By default headers are not
  367.      quoted in mail or followup. Setting this item on will enable the quoting
  368.      of such headers.
  369.  
  370.      For example:
  371.  
  372.      HEADERS=ON
  373.  
  374.      If there is no HEADERS item, or HEADERS is set to 'off', headers will
  375.      not be quoted.
  376.  
  377. 7)   At the end of every posting, followup or mail activity a consistent
  378.      confirmatory message is given to show if the item has been send, or
  379.      aborted.
  380.  
  381. 8)   Entering 'z' at the article level, will mark the currently displayed
  382.      article as unread and move to the next article.
  383.  
  384. 9)   With local posting enabled, Snews would append article ID's to the
  385.      ka9q history file without first checking for a lock. Corrected.
  386.  
  387. 10)  The F3 key now permits a number of configuration items to be changed
  388.      'on the fly'. Configuration values changed from this screen are only
  389.      effective for the current session.
  390.  
  391. 11)  Snews articles had an extra space added to the subject line when
  392.      following up postings. This confused other newsreader threading
  393.      algorithms and has been corrected.
  394.  
  395. 12)  Screen sizes of > 25 lines or >80 columns are now better supported.
  396.      (Tested at 132x43).
  397.  
  398. 13)  The minimum length string compare in Subject threading has been
  399.      changed to 15 (was 10) characters. (i.e. a short subject line must
  400.      have > 15 characters before the comparison over only the length of
  401.      the shortest subject is considered sufficient)
  402.  
  403. 14)  An error in the 's' save article / thread routine has been corrected.
  404.      (Under certain circumstances a thread was not saved when the file
  405.      already existed and append was answered 'no'.
  406.  
  407. 15)  Wherever a mail name is requested, a check is made for a domain. If
  408.      no domain is present, the local domain is added.
  409.  
  410. 16)  A bug in alias file handling causing rubbish to be placed in the To:
  411.      line has been fixed.
  412.  
  413. 17)  Handling of Subject lines in changed such that lines starting Re: are
  414.      no longer truncated from the right to the last Re: but from the left
  415.      to the first non Re: item. Subsequent Re:'s will now be displayed.
  416.  
  417. 18)  Null items in Snews.rc are now rejected instead of causing problems.
  418.  
  419.  
  420. Unbatch
  421. =======
  422.  
  423. 1)   Unbatch now truncates subject lines longer than 255 characters. Such
  424.      line lengths are illegal in headers, so nothing important will be
  425.      lost.
  426.  
  427. 2)   Unbatch now only reports failure to load the entire history file if
  428.      verbose mode is set on (-v).
  429.  
  430. 3)   Exit codes are implemented. Successful unbatch sets errorlevel to 0,
  431.      any other error sets errorlevel to 1.
  432.  
  433. Expire
  434. ======
  435.  
  436. 1)   An erroneous error message relating to out of disk space has been 
  437.      corrected.
  438.  
  439. 2)   Exit codes are implemented. Successful expire sets errorlevel to 0,
  440.      any other error sets errorlevel to 1.
  441.  
  442.  
  443. Malcolm S. Muir
  444. 31 Oct 93
  445. ===========================================================================
  446. Simple News 2.0 DIS 1.24
  447. ========================
  448.  
  449.  +-------------------------------------------------------------------------+
  450.  | CAUTION  - COMMAND CHARACTERS HAVE CHANGED IN SNEWS. PLEASE READ THE       |
  451.  |            DOCUMENT 'COMMANDS.DOC' BEFORE STARTING TO USE THIS RELEASE. |
  452.  +-------------------------------------------------------------------------+
  453.  
  454.  
  455. 1.24 is primarily a bug fix of the beta test version 1.23
  456.  
  457. No major changes are incorporated in this release.
  458.  
  459. Support is being added for compilation under either Borland C++ 3.1 or
  460. Microsoft Visual C++ 1.1 using compiler conditionals. The MSVC support
  461. is at present incomplete.
  462.  
  463. Snews
  464. =====
  465.  
  466. 1)   Incorrect items on the help screens have been corrected.
  467.  
  468. 2)   Errors in the colour support have been corrected.
  469.  
  470. 3)   Some spelling mistakes have been corrected.
  471.  
  472. 4)   Accidental omission of the support for swapping out Snews before
  473.      entering the editor, or DOS Shell has been reinstated.
  474.  
  475. 5)   A bug which could cause To:, CC:, etc. lines to be read from the
  476.      body of a quoted article and result in mail / news being misposted
  477.      has been corrected. (Thanks to Graham Toal for finding this)
  478.  
  479. 6)   The From header in the log files contained an erroneous 'Date:'
  480.      string. This has been removed.
  481.  
  482. 7)   F3 will toggle Expert Mode from any menu. The default value of Expert
  483.      Mode set in Snews.rc is not changed by use of F3.
  484.  
  485. 8)   The 'B' report a problem has been enhanced to ask questions relevant
  486.      to the problem being reported, by first presenting a menu of problem
  487.      topics. (e.g. PCElm, Snews ...)
  488.  
  489. 9)   The 'c' (mark thread read) option, when answered with 'n' lost the
  490.      place in the selection menu. Corrected.
  491.  
  492. Expire
  493. ======
  494.  
  495. 1)   Colour support corrected.
  496.  
  497. 2)   A bug leading to one item (the last) in the expire.dat file not being
  498.      used by Expire has been removed. (Thanks to Cliff Stanford for
  499.      finding this)
  500.  
  501. Malcolm S. Muir
  502. 26 Sep 93
  503. ===========================================================================
  504.  
  505. Simple News 2.0 DIS 1.23
  506. ========================
  507.  
  508. Unbatch
  509. =======
  510.  
  511. 1)  An error in file locking which prevented Unbatch working on batch
  512.     files with short names has been fixed.
  513.  
  514. 2)  A new option is added '-d' to force Unbatch to process via disk, not
  515.     memory. If unbatch terminates with an out of memory error, it should
  516.     be run again specifying this flag. When run this way, immediately
  517.     after the error, the remainder of the batch that was previously not
  518.     processed will be unbatched with no missed articles or corruption.
  519.  
  520. 3)  Unbatch now issues a warning message if it is unable to load the whole
  521.     of the history file into memory. You can then exit (and expire some
  522.     news to make space) or continue and risk accepting duplicates as you
  523.     choose.
  524.  
  525. Snews
  526. =====
  527.  
  528. 1)  Snews optionally no longer has the double edit mode, where it is
  529.     necessary to enter edit a second time to edit header lines.
  530.     By setting 'expert=1' in snews.rc the editor will be entered
  531.     immediately with the full article / mail formed ready for editing.
  532.  
  533. 2)  A new item is introduced into the snews.rc configuration file:
  534.  
  535.     editline - the parameter following this line is the command that will
  536.     be passed on the command line when the editor is invoked. It may
  537.     contain a single '%d' which is replaced with the decimal number of the
  538.     first line below the header when the editor is invoked. If your editor
  539.     is unable to accept such a command line, do not define this item in
  540.     snews.rc
  541.  
  542.     This is an example of such a line for use with Brief:
  543.  
  544.     editline=-m"goto_line %d"
  545.  
  546.     This item is only needed if you are using expert mode.
  547.  
  548. 3)  Distribution of a followup posting now follows the same distribution as
  549.     the article that is being commented to. In the absence of a Distribution
  550.     line, no distribution is added.
  551.  
  552. 4)  The default distribution is now not to have a distribution line.
  553.  
  554. 5)  The references line now copies the entire references item from the
  555.     previous article, suffixing it with the article ID of the article that
  556.     is being followed up.
  557.  
  558. 6)  A Follow up article is now posted to all the newsgroups in the Newsgroups
  559.     line of an original posting, not just the group the article is read from.
  560.     If the article contains a Followup-To: line, this is copied to the
  561.     Newsgroups line of the followup article.
  562.  
  563. 7)  Backward search is now available at the thread level for both article
  564.     and subject search.
  565.  
  566. 8)  Search for newsgroup name is now implemented (forwards and backwards) at
  567.     the newsgoup level. On entry to Snews, the initial default newsgroup
  568.     search string is set to "demon" to allow quick selection of the demon
  569.     articles.
  570.  
  571. 9)  It is now possible to send mail from any display in Snews. The command
  572.     is 'M' (Capital M, small m mails an article to someone)
  573.  
  574. 10) To support mail from Snews a new item 'maillog' is added to snews.rc
  575.     This is the name of the pseudo user that is to receive a copy of all
  576.     outgoing mail. If not set in snews.rc, this item defaults to 'outmail'.
  577.  
  578. 11) Cc: Bcc: and Bc: lines are supported in mail items sent from Snews
  579.     using the 'm', 'M' 'r' and 'R' commands. To enter the copy destinations
  580.     either enter the edit option again when asked if you want to (S)end
  581.     (E)dit or (A)bort, or enable expert mode.
  582.  
  583. 12) To: Cc: Bcc: and Bc: lines can have multiple recipients. Recipients
  584.     can be separated by space, comma, tab or on sequential new lines, 
  585.     each with a leading space. Multiple TO: destinations can be entered to
  586.     the Snews mail prompt, or edited into the message later. Empty Cc: Bcc:
  587.     and Bc: items do not need to be removed from headers, as they are
  588.     deleted by Snews if found to be blank. To enter the copy destinations
  589.     either enter the edit option again when asked if you want to (S)end
  590.     (E)dit or (A)bort, or enable expert mode.
  591.  
  592. 13) Many new commands have been added. These are outlined on the Help
  593.     screens and in the new Commands document. Command keys in most
  594.     cases follow TIN conventions. Upper and lower case versions of key
  595.     strokes are not necessarily identical. (see commands.doc)
  596.  
  597. 14) A number of existing command keys have changed. Significantly 'p'
  598.     for post is now 'w' for write. Such changes are to give closer
  599.     conformity to the TIN newsreader.
  600.  
  601. 15) A number of prompts have been removed. Snews expert mode (or the
  602.     second edit of article / mail) places uncompleted or default header
  603.     lines in the article / mail it presents for editing. If empty items
  604.     (e.g Cc:) are not filled in during edit, they are removed before
  605.     sending the item.   
  606.  
  607. 16) A startup screen has been added to Snews. This is primarily to identify
  608.     the version of Snews. This allows me to remove the version ID from
  609.     the headers, releasing the space for better use.
  610.  
  611.     There is a new 'v' command to view the version information from any
  612.     command level.
  613.  
  614. 17) The free memory display is moved to the bottom prompt line, again to
  615.     release space in the headers.
  616.  
  617. 18) To support those users asking for a prompt before being dropped into
  618.     DOS when pressing 'q' or ESCAPE from the Newsgroup display, a new item
  619.     'exitconfirm' has been added to snews.rc
  620.  
  621.     The default is not to ask for confirmation, however by adding the
  622.     following line:
  623.  
  624.     exitconfirm=1
  625.  
  626.     to snews.rc, an 'Are you Sure ?' prompt will be asked before Snews
  627.     exits to DOS.
  628.  
  629. 19) The Quotemark item in snews.rc now supports the use of the underscore
  630.     character (_) as a space. i.e. if you place underscore characters in
  631.     the quotemark item, they are converted to spaces when quoting.
  632.  
  633. 20) It is possible to stop the copy of mail and/or articles being placed
  634.     into the mail files by setting the mailuser and/or mailog items in
  635.     snews.rc to either a blank string or the key word "none".
  636.  
  637. 21) An expert mode is defined in snews.rc using the key word "expert". It
  638.     is set to either "0" or "1" and defaults to not using expert mode. 
  639.     expert=1  sets expert mode on.
  640.  
  641. 22) Shell to DOS has been added to Snews. It is available from any screen
  642.     by typing "!" (exclamation mark). Remember to type "exit" to get back
  643.     to snews. Snews is swapped to XMS/EMS/DISK on shelling out so as much
  644.     low memory as possible is free for your DOS session.
  645.  
  646. 23) Limited support for PCElm style aliases has been added to the 'R' reply
  647.     to someone, 'm' mail article to someone and 'M' send mail commands.
  648.  
  649.     Aliases are only expanded from the Snews prompts, not as a result of
  650.     editing the header lines. Aliases are not expanded recursively.
  651.  
  652.     To support this a new item is added to the Snews.rc file, aliasfile.
  653.     This should contain the fully qualified name of the alias file. (the
  654.     full name of the file should be given, not just a directory) e.g.
  655.  
  656.     aliasfile=c:\nos\pcelm\alias
  657.  
  658.     where the alias file is called 'alias' with no extension.
  659.  
  660.     The default is not to look for aliases if this item is not included
  661.     in the snews.rc file.
  662.  
  663. 24) Expert mode now affects the prompts that appear for confirmation on
  664.     killing and restoring threads. In expert mode the commands have
  665.     immediate effect. In normal mode, the commands ask for confirmation
  666.     as documented.
  667.  
  668. 25) A 'B' - Mail a support (Bug) question to the Internet Support Team
  669.     option has been added. This can be activated from any selection menu
  670.     by entering 'B' (upper case). Snews asks for details of the problem
  671.     followed by a set of questions relating to your set up. The DOS
  672.     command line editor is used, thus this option will work even if you
  673.     are unable to get the Snews editor option to function.
  674.  
  675.  
  676. Malcolm S. Muir
  677. 11 September 1993
  678. ============================================================================
  679.  
  680. Simple News 2.0 DIS 1.22
  681. ========================
  682.  
  683. 1)  I have now succumbed to passing the source through a c beautifier and
  684.     have started to tidy it up to make it easier for me to work on. My
  685.     apologies to anyone keeping diffs, but the time had to come.
  686.  
  687. 2)  Snews DIS 1.22 is now based on version 2.0 of Snews.
  688.  
  689. 3)  I have incorporated a number of my own ideas / changes to make Snews
  690.     less memory hungry and (in places) faster.
  691.  
  692. 4)  The 'permitted posting file' "ng" is now optional. If this file does
  693.     not exist, posting will be permitted to all newsgroups, even fictitious
  694.     ones.
  695.  
  696.     If the "ng" file is found in the Snews directory, it is used as
  697.     previously documented.
  698.  
  699. 5)  The use of the heap debugger testmall has been removed as I now have 
  700.     access to Nu-Megga Bounds Checker (recommended).
  701.  
  702. 6)  The module VIDEO and the files VIDEO.* have been renamed to SCREEN and
  703.     SCREEN.* to remove a key word conflict with Bounds Checker.
  704.  
  705. 7)  Many minor bugs have been fixed, the principle changes are noted
  706.     below. No doubt new bugs have been introduced. Please continue to
  707.     report them, along with feature requests.
  708.  
  709. UNBATCH
  710. =======
  711.  
  712. 8)  Unbatch now processes items in memory (provided they fit) as opposed
  713.     to in a file ($$item) on disk. This will (I hope) eliminate the
  714.     problems with unbatch crashing on large batches, leaving temporary
  715.     files around etc. Unbatch checks for a minimum of 64K free memory
  716.     (after loading the history) before proceeding. If unbatch is unable
  717.     to fit an article in memory, it unbatches via disk in the file $$item
  718.     which is now created following the path set for the temporary files
  719.     in snews.rc
  720.  
  721.     THE ENVIRONMENT VARIABLES 'TMP' & 'TEMP' ARE NO LONGER USED, PLEASE
  722.     CHECK THAT YOUR SNEWS.RC HAS A VALID TEMPORARY FILE *PATH* SET. (i.e
  723.     a path, not a file name) Unbatch will refuse to run if it is unable
  724.     to create a file on this temporary path.
  725.  
  726.     Unbatch uses the rfc1036 style batch header to determine the length
  727.     of an article. The current version of ka9q (2.11) provides this
  728.     information in its headers. If Unbatch can not determine article
  729.     sizes from the headers, all processing will be on disk.
  730.  
  731. 9)  Unbatch when scanning for new newsgroups would pick up Newsgroup:
  732.     lines from the body of an article in error. Corrected.
  733.  
  734. 10) Unbatch will now invoke Snews at the end of a successful unbatch by
  735.     using the command line parameter -x when starting unbatch. Snews is
  736.     searched for in the current directory, then in the path and must be
  737.     called 'snews.exe'.
  738.  
  739. 11) When invoked with -a or -i all newsgroups found were not added (the
  740.     last one found was dropped). Corrected.
  741.  
  742. 12) Unbatch now correctly checks the drive on which the newsbase resides
  743.     for free space, not the drive on which the nntp batch resides.
  744.  
  745.  
  746. ADDGROUP
  747. ========
  748.  
  749. 13) The line ending for groups added to ng by addgroup was Unix style, now
  750.     corrected to DOS style. (I had previously corrected active, but not ng)
  751.  
  752. 14) If the posting authorisation file 'ng' does not exist addgroup no longer
  753.     reports an error, but simply passes comment.
  754.  
  755. RMGROUP
  756. =======
  757.  
  758. 15) Rmgroup now removes groups from the ng file. If the posting
  759.     authorisation file 'ng' does not exist, addgroup passes comment,
  760.     but does not consider it an error.
  761.  
  762. EXPIRE
  763. ======
  764.  
  765. 16) Expire failed to turn off archiving in some circumstances when
  766.     changing newsgroups, corrected.
  767.  
  768. 17) Expire placed an invalid separator between items in the archive file,
  769.     corrected.
  770.  
  771. 18) Expire now reports the newsgroup name if it finds an error.
  772.  
  773. SNEWS
  774. =====
  775.  
  776. 19) It is now possible to override the default ID (mail2news) that news
  777.     articles are sent to for posting by Demon. The item "newsid" in snews.rc
  778.     sets this ID.
  779.   
  780.     'newsid=mail2news'
  781.  
  782.     This item is optional and defaults to mail2news. It is provided as an
  783.     insurance against any future changes that may be made to the handling of
  784.     news at Demon.
  785.  
  786. 20) Snews previously did not place a To: line into headers of news articles.
  787.     This could possibly break some mail systems. An appropriate To: line
  788.     has now been added.
  789.  
  790. 21) The Organisation: header line was still being picked up as rubbish in
  791.     certain circumstances. Hopefully fixed this time.
  792.  
  793. 22) The post=local addition to snews.rc for enabling local posting has been
  794.     extended.
  795.  
  796.     Placing 'post=local' into snews.rc will, as before, cause articles you 
  797.     write to be placed immediately into the local newsbase and not be
  798.     requested from demon. (i.e. duplicates are prevented) However this
  799.     article will not now be marked as read.
  800.  
  801.     Articles posted locally in this way are not presented immediately for
  802.     reading, but only after returning to the main Newsgroup display. Of 
  803.     course if posting is done at the Newsgroups display, the article is
  804.     presented immediately. This restriction will be addressed in a later
  805.     release.
  806.  
  807.     The previous behaviour of marking locally posted articles as read
  808.     without them being actually read can be re-enabled by changing the
  809.     snews.rc line to read 'post=local/read'.
  810.  
  811.     If both lines are placed into snews.rc (they should *not* be) only the
  812.     latest line in the file will have effect.
  813.  
  814. NOTE - The memory display at the bottom of the screen shows a loss of memory
  815.        as articles are posted with local posting enabled. This is not a 
  816.        memory leak (this has been confirmed using Nu-Megga Bounds Checker)
  817.        but rather is due to fragmentation of the local heap when the read
  818.        list is regenerated in memory.
  819.  
  820. 23) The configured colours were not honoured on the opening screen of
  821.     Snews. Corrected
  822.  
  823. 24) Both upper and lower case letters are now accepted for all commands,
  824.     except those that have different meanings for upper and lower case.
  825.  
  826. 25) '?' no longer accesses the help screens due to a conflict with the
  827.     search facility. I am told that the use of '?' as a search command
  828.     is a standard (vi ?). Help is still available from 'F1' and 'h'/'H'.
  829.  
  830. 26) From the thread display, <backspace> now takes you to the last (read
  831.     or unread) article in the selected thread. (i.e. the reverse action
  832.     to the <enter> key)
  833.  
  834. 27) Search (forwards) through subjects with '+' or through whole articles
  835.     with '/' from the thread selection level. If searching through whole
  836.     articles, Snews moves only the pointer to the thread in which there
  837.     is an article containing the selected text. You then have to press
  838.     <enter> or <tab> to open the thread. If you want to get the actual
  839.     article containing the text, press '/' or '+' and then just hit
  840.     <enter>. I think it would be a bit confusing if Snews were to move
  841.     you directly to the article, because you would not have had the 
  842.     opportunity to see the thread in which the article was found.
  843.  
  844.     Regular expressions are not supported. If anyone can point me at some
  845.     compact PD (or GNU) source for regular expression searching, I would
  846.     be grateful.
  847.  
  848.     Searching is also on a line by line basis and does not extend across
  849.     line boundaries.
  850.  
  851. 28) Snews can now save (articles or extracts) in full even if they cause
  852.     a 'memory low, partial article only' error when attempting to view
  853.     the article.
  854.  
  855. 29) The name entered for saving articles is now sticky, remaining as the
  856.     default for the session. This also applies to the string given for
  857.     searching.
  858.  
  859. 30) Printing of an article is now directly supported by use of <Control+P>
  860.     from the display of an article. Output is to the standard printer
  861.     device. A form feed is automatically sent after an article is printed.
  862.  
  863. 31) Snews now reports an error if it is unable to run the editor for any
  864.     reason. The failed command line passed to the shell is shown.
  865.  
  866. 32) Use of the <TAB> key at the newsgroup and thread display is now
  867.     consistent. <TAB> enters the first newsgroup with unread items
  868.     from the newsgroup screen. Previously is did not enter the thread
  869.     screen unless <ENTER> was pressed. The up/down arrow and page keys
  870.     still move up and down the newsgroup screen.
  871.  
  872. 33) In the JUNK group, snews now shows the actual newsgroup in the status
  873.     banner at the top of the screen whilst read an article, rather than
  874.     junk. I have considered displaying this at the thread screen, but I
  875.     can't at the moment see a way to do it without an unacceptable impact
  876.     on memory use.
  877.  
  878. 34) Also see the document 'commands.txt' which is a full description of
  879.     the key commands supported by Snews 1.22 Numerous additional keys are
  880.     available and slight changes have been made to existing key functions.
  881.  
  882. 35) The help screens accessed by F1 have been extended to show the new
  883.     and changed key strokes available.
  884.  
  885. REINDEX
  886. =======
  887.  
  888. 36) A menu of available newsgroups is now presented if reindex is started
  889.     without a newsgroup name on the command line.
  890.  
  891.  
  892. NEW UTILITY - LSI
  893. =================
  894.  
  895.     LSI (Logical Snews Indexer) is a utility to re-build the file 'active'.
  896.     LSI is written and maintained by rjb@sound.demon.co.uk and distributed
  897.     with Snews as a useful extra. Source is available with the full Snews
  898.     source archive on demon. My thanks to Rob for his work.
  899.  
  900. malcolm@muir.demon.co.uk
  901. 5 July 93
  902. ============================================================================
  903.  
  904. Changes to Snews introduced in version 1.21
  905.  
  906. 1)  When presented with an article that is larger than will fit in memory
  907.     Snews abruptly aborts to DOS (leaving lock files in the process). This
  908.     has been addressed by detecting low memory and and only reading that
  909.     part of the article that will fit into memory.
  910.  
  911.     NOTE: This release does not permit the saving of articles longer than
  912.           can fit in memory, only part articles will be saved. This is
  913.           better than available in versions < 1.21 where Snews aborted with
  914.           large article saving !
  915.  
  916.           A later version will address this, but there is a pressing need
  917.           for release due to item 2).
  918.  
  919. 2)  Due to the unusability of the standard Borland library implementation
  920.     of tzset during Summertime of 1993, this function has been replaced
  921.     with tzset12 by Giles Todd. Source for this module is available on
  922.     ftp.demon.co.uk in the directory /pub/ibmpc/misc as tzset12.zip.
  923.  
  924.     This change extends the syntax of the TZ environment variable.  Full
  925.     details are contained in the archive referred to above.  UK users in
  926.     1993 must set the TZ environment variable as follows for correct
  927.     operation: 
  928.  
  929.     set TZ=GMT0BST1,M3.4.0/02:00,M10.4.0/02:00
  930.  
  931.     In the unlikely event that this interferes with the correct
  932.     operation of other applications, this string may be assigned to the
  933.     GTZ environment variable instead.
  934.  
  935. malcolm@muir.demon.co.uk
  936. 6/3/93
  937. ============================================================================
  938. Changes to Snews introduced in version 1.20
  939.  
  940. 1)  Expire supports a new variable in the file expire.dat used on
  941.     selective expiry:  [LIFE] - if this appears in the file, it must be
  942.     followed by a number to indicate the maximum period in days that an
  943.     article's history details are retained in the file history.snw This
  944.     parameter prevents the history file growing continually and slowing
  945.     down Snews. The setting of [LIFE] has no effect on the retention of
  946.     articles in the newsbase, only the history information relating to
  947.     them. [LIFE] should be set to longer that the period news is retained
  948.     on the host to be sure repeated articles are not added to the newsbase.
  949.  
  950. 2)  Expire now supports archiving of items expired from a news group.
  951.     To archive a newsgroup, add the name of the archive file to the
  952.     end of an appropriate line in expire.dat The format of the expire.dat
  953.     file is now:-
  954.  
  955.         Newsgroup     Time File
  956.      e.g.   demon.support  30  g:\demon\support.acv
  957.  
  958.     Each field should be separated from the next by whitespace. The first
  959.     two fields are mandatory, the filename is optional.
  960.  
  961.     When a filename is present, any articles removed from the newsgroup
  962.     will be appended to this file. The same file can be used for any number
  963.     of newsgroups. Articles are written to this file in the same form as
  964.     the batch.txt file written by ka9q.
  965.  
  966. 3)  The article display 'Article: x of y' overflowed if there were more
  967.     than 99 articles in a thread. Now expanded to 999.
  968.  
  969. 4)  The X-header was X-Mailer instead of X-Newsreader. Corrected.
  970.  
  971. 5)  Snews would pick up rubbish for the Organisation and Author fields
  972.     under various circumstances. Corrected.
  973.  
  974. 6)  Unbatch would change the directory on non default drives when testing
  975.     for the existence of paths specified in environment variables. These
  976.     drives are now returned to the path they have on entry to unbatch.
  977.  
  978. 7)  The current line number (of the first line displayed) is shown in the
  979.     header of the article display in the form "xxxx / yyyy lines".
  980.  
  981. 8)  Unbatch now checks the article length, if available. 'Rnews' tokens in
  982.     article bodies should now be skipped. This behaviour can be overridden
  983.     with a new -l (for length_check) command line parameter.
  984.  
  985. 9)  Unbatch can optionally add any new newsgroups it finds to the newsbase.
  986.     Two options are available controlled by command line parameters.
  987.  
  988.             -a - add automatically (i.e. without asking) any new newsgroups
  989.                  found in the newsbatch files. (Default is off)
  990.  
  991.             -i - add interactively (i.e. ask first) any new newsgroups
  992.                  found in the newsbatch files. (Default is off)
  993.  
  994.         If both -a and -i are set, the last option on the command line
  995.         will prevail.
  996.  
  997.     The addition of new groups for cross posted articles is controlled
  998.         by the setting of the junk flag. Any articles that would otherwise
  999.         be posted to the Junk newsgroup will be considered for addition.
  1000.  
  1001.         For this option to work, unbatch must be able to execute addgroup.
  1002.         Please ensure that addgroup is on your path, or in the default
  1003.         directory before enabling this option of unbatch.
  1004.  
  1005.         Note that the fetching of new newsgroups is not affected by these
  1006.         option settings. You still need to edit nntp.dat or autoexec.net
  1007.         to fetch new newsgroups !
  1008.  
  1009.       AUTHORS NOTE - This option was added at the request of users. Be
  1010.                      warned that using the -a option without the -j option
  1011.                      can result in many obscure and weird newsgroups being
  1012.                      added to your newsbase !  I strongly recommend that
  1013.                      the official front end manager DIS.EXE is used to 
  1014.                      maintain your newsgroups.
  1015.  
  1016. 10)  Snews correctly quotes From: names if they contain any RFC822 prohibited
  1017.      characters. (e.g. '.')
  1018.  
  1019. 11)  The option messages in Unbatch.exe have been changed into readable
  1020.      English :-)
  1021.  
  1022. 12)  A new option has been added to Unbatch -s which when specified stops
  1023.      unbatch checking for free space prior to unbatching news. This option
  1024.      should be set if you encounter problems on networked systems.
  1025.  
  1026. 13)  A code error in unbatch resulted in the temporary file $$item being
  1027.      opened twice in succession with no intervening close. - corrected.
  1028.  
  1029. 14)  A bug has been fixed in the code testing for temporary directories
  1030.      whereby a pathname was incorrectly formed.
  1031.  
  1032. 15)  Following a suggestion that some networks are unable to handle opening
  1033.      a file when passed a fully qualified file name, the code to handle this
  1034.      in unbatch has been changed to a) change drive; b) change directory;
  1035.      then c) open the file.
  1036.  
  1037. 16)  Local news posting has been re-enabled as an option. If you want to see
  1038.      your postings appear immediately in your local newsbase, add the
  1039.      following item to the snews.rc file in the snews directory:-
  1040.  
  1041.      Post=Local
  1042.  
  1043.      The "post" keyword is not a required item in the configuration file,
  1044.      but if present, and followed by the keyword "local" any item posted
  1045.      from snews will be immediately added to your local newsbase and an
  1046.      entry made in the nntp history file to prevent the item being requested
  1047.      from demon. If you use this option, you must not delete the nntp
  1048.      history file, or remove recent items from it if you wish to avoid
  1049.      duplicate items being fetched. Also the snews history is updated so
  1050.      in the event of actually receiving the message from demon, it will
  1051.      be rejected by unbatch, assuming the snews history file is not deleted.
  1052.  
  1053. 17)  When posting an article (either new or followup) the edit option now
  1054.      permits editing of the whole article. If the number of lines in the
  1055.      article is changed, the Lines: line in the header is automatically
  1056.      updated after the article has been saved. After entering edit, the
  1057.      options available for changing the article are limited to Edit, Post
  1058.      and abort.
  1059.  
  1060. 18)  When 'r'eplying or 'R'eplying to an article, the Edit option now 
  1061.      permits editing of the whole article, including headers.
  1062.  
  1063. 19)  It is now possible to edit the contents of the message formed when
  1064.      'm'ailing an article to someone.
  1065.  
  1066. 20)  A further 3 occasions where blank lines were inserted at the top of
  1067.      mail / articles have been fixed.
  1068.  
  1069. malcolm@muir.demon.co.uk
  1070. 15/2/93
  1071. ===========================================================================
  1072.  
  1073. Changes to Snews 1.90 DIS 1.19
  1074.  
  1075. NOTE - 1.19 is a bug fix release only. It addresses bugs reported in
  1076.        release 1.18. There are no new features in this release.
  1077.  
  1078. 1)  Unbatch now prints message lengths in verbose mode, if a message
  1079.     length is available.
  1080.  
  1081. 2)  Lock files are removed when a) created by Unbatch and b) a controlled
  1082.     exit occurs. NOTE - unbatch does not include a critical error handler
  1083.     and will leave lock files around if an uncontrolled error occurs
  1084.     (i.e. a DOS disk full error)
  1085.  
  1086. 3)  The use of TMP / TEMP environment variable has changed as:-
  1087.  
  1088.     If TMP is defined and the directory exists, it is used first.
  1089.     If TEMP is defined and the directory exists, it is used next.
  1090.     If none of the above apply, the default directory is used.
  1091.  
  1092. 4)  When the option to change the subject, followupto or distribution field
  1093.     of a posting was taken, there was no way to back out without losing the
  1094.     previous content of the field. Now, if the entry is simply a return, the
  1095.     old entry is retained. To delete the entry, enter a single space.
  1096.  
  1097. 5)  When entering a followup to an article an extra blank line was added
  1098.     to the beginning of the article, now removed.
  1099.  
  1100. 6)  If the Reply-To: entry in snews.rc was omitted or left blank, an
  1101.     empty Reply-To: line appeared in postings. Corrected.
  1102.  
  1103. 7)  Follow-up to 'poster' is now correctly handled as mail to the
  1104.     poster of the article, not a posting to newsgroup poster
  1105.  
  1106. 8)  Reindex failed when the newsgroup contained an article with a blank
  1107.     or non-existent Subject line. Corrected.
  1108.  
  1109. 9)  Expire now uses the colour settings from snews.rc in place of its own.
  1110.  
  1111. 10) The need to continually answer 'Y' in reindex is overcome with a new
  1112.     'D' (Don't ask) reply. Answering 'D' to the first or subsequent prompt
  1113.     will allow processing to complete without stopping.
  1114.  
  1115. 11) Reindex now correctly handles a missing index file.
  1116.  
  1117. 12) Reindex now correctly handles empty (i.e. no articles) article and / or
  1118.     index files.
  1119.  
  1120. 13) Addgroup placed Unix style, instead of DOS style line endings after
  1121.     newly added groups. This appears to have no ill effects on Snews, but
  1122.     is now corrected.
  1123.  
  1124. 14) The makefiles were not all updated to reflect the new modules added
  1125.     in Snews 1.18. As I am unable to test changes to these makefiles they
  1126.     have been deleted.
  1127.  
  1128. ============================================================================
  1129. Changes made to Snews DIS 1.18 by MSM.
  1130.  
  1131. Snews DIS version 1.18 is based on Snews 1.90 as opposed to 1.12
  1132.  
  1133. The following are the main functional changes included from snews 1.90 :-
  1134.  
  1135. 1)  Support for the use of colour in snews displays. The default colours
  1136.     are the same as DIS 1.17. Colours are defined by the use of the COLOUR
  1137.     keyword in snews.rc (Note UK spelling) as follows:-
  1138.       
  1139.        colour helpf   - Set help screen forground colour
  1140.        colour helpb   - Set help screen background colour
  1141.        colour textf   - Set text forground colour
  1142.        colour textb   - Set text background colour
  1143.        colour headf   - Set header forground colour
  1144.        colour headb   - Set header background colour
  1145.        colour msgf    - Set message forground colour
  1146.        colour msgb    - Set message background colour
  1147.       
  1148.     Colours are selected from :-
  1149.    
  1150.        White Black Blue Green Red Magenta Cyan Yellow (Case irrelevant)
  1151.        A '+' added to the end of a name (e.g. red+) sets forground intensity
  1152.          
  1153.     A typical snews.rc entry would be:-
  1154.    
  1155.     # Snews.rc colour definition section.
  1156.     colour helpf yellow+
  1157.     colour helpb black   
  1158.     colour textf green
  1159.     colour textb black
  1160.     colour headf blue
  1161.     colour headb white
  1162.     colour msgf blue
  1163.     colour msgb white
  1164.  
  1165. 2)  The help screens from snews 1.9 are used, modified to match DIS changes.
  1166.  
  1167. 3)  Help is now accessible from the F1 key.
  1168.  
  1169. 4)  A new screen shows current values as read from snews.rc. Access is by
  1170.     using F2.
  1171.  
  1172. 5)  An optional Reply-To: line is supported in newsgroup postings.
  1173.     This is activated by adding a replyto item in snews.rc.
  1174.     It should contain the FQDN for mail to be sent in reply to news postings.
  1175.     If the entry is not found, Reply-To: lines will not be added.
  1176.    
  1177.     Example:-
  1178.    
  1179.     # Reply to entry
  1180.     replyto someone@somewhere.demon.co.uk
  1181.     #
  1182.     
  1183.     This entry could be used if you wanted to post news from ka9q to demon
  1184.     but receive any mail replies on for example CIX.
  1185.  
  1186.     The same Reply-To is used in mail from snews.
  1187.  
  1188. 6)  A 'W' Write Thread/Article option to append the current Thread or Article
  1189.     to a file in a form readable by mail. This file will be in the ka9q
  1190.     incoming mail directory (~/spool/mail)
  1191.  
  1192.     The name of the file (or pseudo user) defaults to 'snewsex'    unless
  1193.     defined in snews.rc using the new keyword extracts. e.g.
  1194.     
  1195.     # Mail Pseudo User Name for the news extracts file
  1196.     #
  1197.     extracts=extracts
  1198.     #
  1199.  
  1200. 7)  Postings and mail now have the correct termination ("-- ") prior to the
  1201.     signature.
  1202.  
  1203. 8)  The surplus blank line at the beginning of every article (most noticeable
  1204.     when quoting) is eliminated.
  1205.    
  1206. 9 ) New option 'R' from the article read screen allows mail to be sent to
  1207.     someone, optionally quoting the article. The recipient of the mail
  1208.     is entered at the prompt, rather than taken from the article. This
  1209.     permits a reply to be sent to, for example the original poster, in
  1210.     a 'references <xxx>' type article.
  1211.     
  1212.     NOTE the distinction between 'r' for reply to reply-to address and
  1213.      'R' for reply to any address.
  1214.  
  1215. 10) Snews now allows for mail and postings to be re-edited, posted or
  1216.     aborted upon exiting the editor.
  1217.  
  1218. 11) The subject line of a follow-up posting can be changed.
  1219.  
  1220. The following corrections have been made to snews DIS 1.17 :-
  1221.  
  1222. 1)  Colour processing only permitted seven forground colours in bios.c
  1223.     this has been changed to permit all 16 colours to be displayed.
  1224.  
  1225. 2)  ROT13 display of articles, was present in 1.17 but not shown on the
  1226.     help screen. This is now shown.
  1227.  
  1228. 3)  If a followup was requested but the original article not quoted, the
  1229.     references line was missing from the header. Now corrected.
  1230.  
  1231. 4)  Unbatch would pick up Subject: lines from the body of an article.
  1232.  
  1233. 5)  Expire would pick up Subject: lines from the body of an article, changing
  1234.     the correct entry for articles that were not deleted during expire.
  1235.     
  1236. The following additions/changes have been made to snews DIS 1.17
  1237.  
  1238. 1)  Unbatch in verbose mode now shows a count against each Message-ID
  1239.     processed as an indication of progress.
  1240.  
  1241. 2)  Unbatch flushes writes to history.snw as a precaution against crashing
  1242.     during processing.
  1243.  
  1244. 3)  Unbatch checks for article and history locks and will refuse to process
  1245.     articles if either the article file or history file are locked.
  1246.  
  1247. 4)  Unbatch sets locks on article and history files during processing.
  1248.  
  1249. 5)  Snews sets locks on user and history files during news reading.
  1250.     (History is locked to stop unbatch running whilst news is being read.
  1251.     A side effect due to the use of the same file name is to stop nntp
  1252.     fetching news. Equally two copies of snews will not run together. These
  1253.     restrictions need addressing). 
  1254.     
  1255. 6)  Snews would wrap lines at col50 if no suitable place could be found
  1256.     between col50 and col79. This corrupted numerous signatures using
  1257.     long single character lines. Changing the search to start at col80
  1258.     clears the problem and has no ill effects.
  1259.  
  1260. 7)  Unbatch would complain about a missing history.snw the first time it
  1261.     was run. Unbatch now asks if it may create this file when it can't be
  1262.     found.
  1263.  
  1264. 8)  The post log is now created in kq9a mail format in the mail directory.
  1265.     Posted messages can be viewed / processed as if they were mail. The name
  1266.     of the pseudo user to receive this information is defined by the
  1267.     new item mailuser in snews.rc. e.g.    (It will default to 'newspost')
  1268.     
  1269.     # The name of the Pseudo Mail User that receives the news postings
  1270.     #
  1271.     mailuser=postlog
  1272.     #
  1273.  
  1274. 9)  The Distribution line in postings can now be changed from the default
  1275.     of 'world'. If a null (blank) entry is made, the Distribution line is
  1276.     omitted from the header.
  1277.     
  1278. 10) The follow-up posting now has Re: prefixed to the subject line as per
  1279.     RFC1036.
  1280.     
  1281. 11) RFC1036 style headers (#! rnews 12345) are now accepted by unbatch. The
  1282.     article length is currently ignored. This will permit ka9q to be updated
  1283.     to write such headers.
  1284.  
  1285. 12) ADDGROUP now gives an informative message for each group added.
  1286.  
  1287. 13) ADDGROUP now adds new groups to the ng (posting allowed) file by default.
  1288.     You need to remove entries from this file if you wish to prevent posting.
  1289.  
  1290. 14) A Followup-To header line can now be placed into any article.
  1291.  
  1292. 15) The environment item 'tmp' or 'temp' is now used for temporary files
  1293.     created by unbatch.
  1294.  
  1295. 16) Expire now supports a newsgroup based number of days for the life of
  1296.     articles. The old syntax is still supported and performs as before,
  1297.     however if the command is entered as only 'expire' the file expire.dat 
  1298.     in the snews directory is searched for expiry information. See the
  1299.     sample expire.dat for the format of this file.
  1300.  
  1301. 17) Snews 1.17 compared the entire length of subject lines when forming its
  1302.     threads. I have changed this to compare only for the length of the
  1303.     shorter, provided it is longer than 10 characters. This has improved the
  1304.     threading, particularly where long subject lines have been truncated by
  1305.     followup posters. (But at the small risk of relating unrelated articles.)
  1306.     
  1307. 18) Unbatch 1.18 looks for control messages in newgroups. If any are found they
  1308.     are    placed in the control newsgroup (or junk if control does not exist)
  1309.     for processing by a future release of snews.
  1310.  
  1311. 19) "Followup-To: poster" is now handled correctly.  The user is asked
  1312.     if he or she wants to send mail rather than post to the group.
  1313.  
  1314. New Utility REINDEX.
  1315.  
  1316.     A new utility programme called reindex is added to the snews suite. This
  1317.     utility will attempt to correct the 'index file corrupt' and 'article xxx'
  1318.     found when yyy expected' errors reported by snews.
  1319.     
  1320.     Reindex is run from the DOS prompt. It processes one news group at a time.
  1321.     The name of the news group to process can either follow on the command
  1322.     line, or will be prompted for.
  1323.     
  1324.     For each article, reindex will display the current index entry and the
  1325.     correct entry from the article file. If these differ, you will be asked
  1326.     if you wish to correct the entry.
  1327.     
  1328.     At the end of processing reindex saves the old index file with a .bak
  1329.     name. These files should be deleted once you are happy that snews is
  1330.     functioning with the newsgroup.
  1331.     
  1332.     As reindex is not able to know the posting time of articles when it
  1333.     repairs indexes, it takes a best guess at the value to place in the
  1334.     index. This means that articles may be expired sooner or later than
  1335.     anticipated.
  1336.     
  1337.     Reindex does not touch the user.nrc file containing the details of
  1338.     read articles. Edit this file by hand if it is important to you.
  1339.     (I just re-read those articles I think I've missed)
  1340.  
  1341.     NOTE - Reindex works for me on the corrupt newsbase files I have found
  1342.            and used for tests. Reindex does not delete any files except those
  1343.            with a .bak extension. It does however modify the snews file
  1344.            'active' and 'username.nrc' It would be prudent to backup these
  1345.            two files before use.
  1346.     
  1347.            Reindex may be called to repair newsbases corrupted in ways I
  1348.            have neither tested nor thought of !
  1349.            
  1350.            I can give no guarantee that it will not leave your newsbase
  1351.            in a worse condition than it finds it. Please backup any
  1352.            essential files before running reindex.
  1353.            
  1354. Please continue to notify snews problems to malcolm@muir.demon.co.uk
  1355.  
  1356. ---------------------------------------------------------------------------
  1357.  
  1358. Changes made to unbatch 1.8 by MSM.    (snews 1.2 DIS 1.17)
  1359.  
  1360. 1) All progress and error messages now output to stderr in the format
  1361.    'UNBATCH: message'
  1362.  
  1363. 2) If command line flags are set, an appropriate initialisation message
  1364.    is given to confirm the processing.
  1365.  
  1366. 3) A message is given on completion to note the number of messages
  1367.    processed (to compare with ka9q nntp 1.17 message). This message
  1368.    also gives the number of duplicate articles skipped and junk articles
  1369.    posted to junk.
  1370.  
  1371. 4) The check for an available batch to process is made earlier in the
  1372.    programme and processing is aborted with an error message if no batches
  1373.    are found.
  1374.  
  1375. 5) A -j flag is added which if given on the command line causes unbatch
  1376.    to post articles to junk only if the article is not posted to an active
  1377.    group. The default is as per previous versions, to post to junk if any
  1378.    group on the articles newsgroups line is not in the active list.
  1379.    [This is the reverse action to the snu116cs -j flag]
  1380.  
  1381. 6) Processing of the input news batch is no longer terminated on finding
  1382.    a Control Z (^Z) in the file. The ^Z is simply passed into the newsbase
  1383.    unchanged. Snews seems to cope with this OK.
  1384.  
  1385. 7) A -f flag is added which if given on the command line causes unbatch
  1386.    to filter non-printable characters out of the text passed into the
  1387.    newsbase, replacing them with question marks (?). Tab, Formfeed,
  1388.    Linefeed and CR characters are processed normally.
  1389.  
  1390.  
  1391. Please notify any problems to malcolm@muir.demon.co.uk
  1392.  
  1393. ==============================================================================
  1394.  
  1395. ----------------------------------------------------------------------------
  1396.  
  1397. 1.16 DIS  17 Jul 92 <gt@rundart.demon.co.uk>
  1398.  
  1399. 1) Modified all source modules so that the program now compiles cleanly
  1400. in BC's C++ mode.  The extra static error checking offered by C++ picked
  1401. up a couple of memory allocation bugs which are now fixed.
  1402.  
  1403. 2) Now swaps out snews to EMS, XMS or file when spawning the editor. 
  1404. This should cure problems loading an editor when short of memory.
  1405.  
  1406. 3) "unbatch" now only posts a single copy of a message to the "junk"
  1407. group.
  1408.  
  1409. 4) Added a PD heap debugging package (testmall.[ch] - thanks go to
  1410. maff@cix) to catch memory leaks.  This can be enabled by recompiling the
  1411. source with DBG_MALLOC defined.  snews is shipped with the package
  1412. disabled by default as it causes quite a performance hit.
  1413.  
  1414. 5) Fixed a memory leak.
  1415.  
  1416. ----------------------------------------------------------------------------
  1417.  
  1418. 1.15 DIS  26 Jun 92 <gt@rundart.demon.co.uk>
  1419.  
  1420. 1) Fixed format of group name display in message header.
  1421.  
  1422. 2) Fixed length of post_date field in TEXT structure.  This cures the
  1423. "post to group GMT" problem which occurs with some messages.  The date
  1424. was overflowing into the "follow_up" field.
  1425.  
  1426. 3) Fixed make file dependencies.
  1427.  
  1428. 4) Changed the name of the history file from "history" to "history.snw"
  1429. to avoid clashes with KA9Q's history file.  This should cure unbatch
  1430. problems which occurred from version 1.12 onwards.
  1431.  
  1432. ----------------------------------------------------------------------------
  1433.  
  1434. 1.14 DIS  24 Jun 92 <gt@rundart.demon.co.uk>
  1435.  
  1436. 1) Unbatch: fixed close of unopened file.
  1437.  
  1438. ----------------------------------------------------------------------------
  1439.  
  1440. 1.13 DIS  16 Jun 92 <gt@rundart.demon.co.uk>
  1441.  
  1442. 1) Post via "mail2news" to allow cross postings.
  1443.  
  1444. ----------------------------------------------------------------------------
  1445.  
  1446. 1.12 gt 12/06/92 <leveret@warren.demon.co.uk>
  1447.  
  1448. 1) Uses as many lines as are currently on the screen (for 43 and 50 line
  1449.    video modes), using own direct video routines 'cos TC2.0 is buggy.
  1450.    Also option for Bios video added (biosvideo=1 in snews.rc).
  1451.  
  1452. 2) Message quoting character is configurable via snews.rc quotemark=
  1453.    parameter. The default quoting character is >. Made it apply to Reply
  1454.    and Forward as well as to Followup.
  1455.  
  1456. 3) Fixed memory leak when pressing Escape whilst reading an article.
  1457.  
  1458. 4) Tidied up keyboard/display interaction whilst reading articles.
  1459.  
  1460. 5) Added 'Organization:' line to Reply and Forward mail messages.
  1461.  
  1462. 6) Added 'q' as an alternative to 'ESC' throughout.
  1463.  
  1464. 7) Rmgroup wasn't deleting the message text file.
  1465.  
  1466. 8) Ensure tabs are also parsed everywhere spaces are tested for.
  1467.  
  1468. 9) Sundry restructuring of knotty routines.
  1469.  
  1470. 10) Appends ALL Message-IDs to %snews/history, not merely cross-posted
  1471.    articles. This is to allow checking for duplicate messages if you add
  1472.    a CIX usenet scratchpad. At present you have to add #!rnews lines to
  1473.    your scratchpad using an awk script, but in the medium term I'd like
  1474.    to see a separate USN2SNEWS unbatcher which checks the NNTP history file.
  1475.  
  1476. ------------------------------------------------------------------------------
  1477.  
  1478. 1.11 gt
  1479.  
  1480. 1) unbatch: only expand "Path:" line in header.
  1481.  
  1482. 2) Removed local posting.  The reason this approach to the "double
  1483. posting" problem was chosen is that it provides positive feedback that
  1484. your message has reached the newsgroup.
  1485.  
  1486. 3) In Groups list, right arrow enters group (like ENTER).
  1487.  
  1488. 4) In Threads list, right arrow enters thread (like ENTER), and left arrow 
  1489. takes you to the groups list.
  1490.  
  1491. 5) In article, right arrow takes you to the next article without marking the 
  1492. current one as read.
  1493.  
  1494. 6) In article, left arrow takes you to the previous article without marking 
  1495. the current one as read. If at the first article, takes you to the threads
  1496. list.
  1497.  
  1498. 7) unbatch: fixed insufficient disc space report.
  1499.  
  1500. Thanks to Nikke Locke (nikki@trmphrst.demon.co.uk) for items 3 to 6.
  1501.  
  1502.  
  1503. 1.10 gt
  1504.  
  1505. 1) Put fully qualified domain name in "Path:" lines.
  1506.  
  1507. 2) unbatch: fixed disc space check.
  1508.  
  1509.  
  1510. 1.9 gt
  1511.  
  1512. 1) Fixed the interpretation of the "mailqueue" parameter in the snews.rc
  1513. file.
  1514.  
  1515.  
  1516. 1.8 gt
  1517.  
  1518. 1) Fixed a NULL pointer dereference and an undefined pointer dereference
  1519. in message history lookup.  These bugs were crashing snews.
  1520.  
  1521.  
  1522. 1.7 gt
  1523.  
  1524. 1) Restores the screen after help display.
  1525.  
  1526. 2) New command: SPACE (' ') at the thread display marks a thread as
  1527. read.
  1528.  
  1529. Thanks to Nikki Locke (nikki@trmphrst.demon.co.uk) for modifications (1)
  1530. and (2).
  1531.  
  1532. 3) Fixed "From:" and "Reply-To:" parsing.  Previous versions did not
  1533. parse names of the form
  1534.  
  1535. "Full Name" <someone@some.machine.out.there>
  1536.  
  1537. correctly.
  1538.